---
title: "Customize Form - Fields Table"
space: "Frappe Framework"
url: "https://support.aakvatech.com/Frappe Framework/customize-form-fields-table"
updated: "2026-07-22"
---

<p>The <strong><code>fields</code></strong> table in the <strong>Customize Form</strong> Doctype allows users to manage individual fields of the selected Doctype. Each row in this table represents a single field of the Doctype and includes various properties that determine its behavior and appearance. Here is a breakdown of the individual fields in the <strong><code>fields</code></strong> table and their usage:</p>
<hr>
<h3 id="-1-label-"><strong>1. <code>label</code></strong></h3>
<ul>
<li><strong>Description:</strong> The display name of the field in the form or list view.</li>
<li><strong>Use:</strong> Modify the label to make it more descriptive or localized for user understanding.</li>
</ul>
<hr>
<h3 id="-2-fieldname-"><strong>2. <code>fieldname</code></strong></h3>
<ul>
<li><strong>Description:</strong> The unique identifier for the field in the database.</li>
<li><strong>Use:</strong> Used in backend logic, scripts, and custom queries. Should remain unique within the Doctype.</li>
</ul>
<hr>
<h3 id="-3-fieldtype-"><strong>3. <code>fieldtype</code></strong></h3>
<ul>
<li><strong>Description:</strong> Specifies the type of field (e.g., Data, Select, Table, Link).</li>
<li><strong>Use:</strong> Determines how the field behaves and what kind of data it can store. For example:<ul>
<li><code>Data</code> for free-text input.</li>
<li><code>Link</code> to link another Doctype.</li>
<li><code>Table</code> to include child tables.</li>
</ul>
</li>
</ul>
<hr>
<h3 id="-4-options-"><strong>4. <code>options</code></strong></h3>
<ul>
<li><strong>Description:</strong> Additional configuration for the field, depending on its type.</li>
<li><strong>Use:</strong> <ul>
<li>For <code>Link</code> fields, specify the linked Doctype.</li>
<li>For <code>Select</code> fields, define the list of options separated by newline.</li>
<li>For <code>Table</code> fields, specify the Doctype of the child table.</li>
</ul>
</li>
</ul>
<hr>
<h3 id="-5-default-"><strong>5. <code>default</code></strong></h3>
<ul>
<li><strong>Description:</strong> The default value of the field when a new document is created.</li>
<li><strong>Use:</strong> Pre-fill commonly used values to reduce user input.</li>
</ul>
<hr>
<h3 id="-6-reqd-required-"><strong>6. <code>reqd</code> (Required)</strong></h3>
<ul>
<li><strong>Description:</strong> Determines whether the field is mandatory.</li>
<li><strong>Use:</strong> Ensure critical information is always provided when saving a document.</li>
</ul>
<hr>
<h3 id="-7-unique-"><strong>7. <code>unique</code></strong></h3>
<ul>
<li><strong>Description:</strong> Ensures the value in this field is unique across all documents of the Doctype.</li>
<li><strong>Use:</strong> Prevent duplicate entries for fields like serial numbers or unique identifiers.</li>
</ul>
<hr>
<h3 id="-8-read_only-"><strong>8. <code>read_only</code></strong></h3>
<ul>
<li><strong>Description:</strong> Makes the field non-editable.</li>
<li><strong>Use:</strong> Protect fields that should not be modified after being set (e.g., system-generated fields).</li>
</ul>
<hr>
<h3 id="-9-hidden-"><strong>9. <code>hidden</code></strong></h3>
<ul>
<li><strong>Description:</strong> Hides the field from the form but stores its value in the database.</li>
<li><strong>Use:</strong> Keep fields hidden but usable in backend logic or automation.</li>
</ul>
<hr>
<h3 id="-10-in_list_view-"><strong>10. <code>in_list_view</code></strong></h3>
<ul>
<li><strong>Description:</strong> Determines whether the field is displayed in the list view.</li>
<li><strong>Use:</strong> Highlight important fields in the list view for quick reference.</li>
</ul>
<hr>
<h3 id="-11-in_standard_filter-"><strong>11. <code>in_standard_filter</code></strong></h3>
<ul>
<li><strong>Description:</strong> Makes the field available in standard filters for reports and list views.</li>
<li><strong>Use:</strong> Allow users to filter documents based on the field.</li>
</ul>
<hr>
<h3 id="-12-bold-"><strong>12. <code>bold</code></strong></h3>
<ul>
<li><strong>Description:</strong> Renders the field&#39;s value in bold.</li>
<li><strong>Use:</strong> Use for emphasizing important fields visually in the form.</li>
</ul>
<hr>
<h3 id="-13-collapsible-"><strong>13. <code>collapsible</code></strong></h3>
<ul>
<li><strong>Description:</strong> Allows the field to be part of a collapsible section.</li>
<li><strong>Use:</strong> Group fields into collapsible sections to improve form readability.</li>
</ul>
<hr>
<h3 id="-14-translatable-"><strong>14. <code>translatable</code></strong></h3>
<ul>
<li><strong>Description:</strong> Indicates whether the field label and values are translatable.</li>
<li><strong>Use:</strong> Enable this for fields that require multilingual support.</li>
</ul>
<hr>
<h3 id="-15-depends_on-"><strong>15. <code>depends_on</code></strong></h3>
<ul>
<li><strong>Description:</strong> Defines a condition for displaying the field based on another field&#39;s value.</li>
<li><strong>Use:</strong> Create dynamic forms where fields are shown or hidden based on user input.</li>
</ul>
<hr>
<h3 id="-16-mandatory_depends_on-"><strong>16. <code>mandatory_depends_on</code></strong></h3>
<ul>
<li><strong>Description:</strong> Specifies a condition for making the field mandatory based on another field&#39;s value.</li>
<li><strong>Use:</strong> Conditionally enforce data entry based on related fields.</li>
</ul>
<hr>
<h3 id="-17-read_only_depends_on-"><strong>17. <code>read_only_depends_on</code></strong></h3>
<ul>
<li><strong>Description:</strong> Specifies a condition for making the field read-only.</li>
<li><strong>Use:</strong> Dynamically protect fields from editing based on other field values.</li>
</ul>
<hr>
<h3 id="-18-description-"><strong>18. <code>description</code></strong></h3>
<ul>
<li><strong>Description:</strong> Tooltip text displayed below the field.</li>
<li><strong>Use:</strong> Provide additional context or instructions for users filling in the field.</li>
</ul>
<hr>
<h3 id="-19-width-"><strong>19. <code>width</code></strong></h3>
<ul>
<li><strong>Description:</strong> Defines the field’s width in the form layout.</li>
<li><strong>Use:</strong> Adjust field width for better alignment in forms.</li>
</ul>
<hr>
<h3 id="-20-precision-"><strong>20. <code>precision</code></strong></h3>
<ul>
<li><strong>Description:</strong> Specifies the number of decimal places for numeric fields.</li>
<li><strong>Use:</strong> Ensure accuracy and consistency for fields like currency or percentages.</li>
</ul>
<hr>
<h3 id="-21-length-"><strong>21. <code>length</code></strong></h3>
<ul>
<li><strong>Description:</strong> Sets the maximum character length for the field value.</li>
<li><strong>Use:</strong> Limit the length of text input for fields like phone numbers or codes.</li>
</ul>
<hr>
<h3 id="-22-fetch_from-"><strong>22. <code>fetch_from</code></strong></h3>
<ul>
<li><strong>Description:</strong> Specifies a field in a linked document from which the value is automatically fetched.</li>
<li><strong>Use:</strong> Auto-populate values based on linked records (e.g., fetch a customer&#39;s address).</li>
</ul>
<hr>
<h3 id="-23-no_copy-"><strong>23. <code>no_copy</code></strong></h3>
<ul>
<li><strong>Description:</strong> Prevents the field&#39;s value from being copied when duplicating a document.</li>
<li><strong>Use:</strong> Useful for fields like status or timestamps that are unique to each document.</li>
</ul>
<hr>
<h3 id="-24-allow_on_submit-"><strong>24. <code>allow_on_submit</code></strong></h3>
<ul>
<li><strong>Description:</strong> Allows editing of the field even after the document is submitted.</li>
<li><strong>Use:</strong> For fields that may require updates after submission, such as comments or remarks.</li>
</ul>
<hr>
<h3 id="-25-in_preview-"><strong>25. <code>in_preview</code></strong></h3>
<ul>
<li><strong>Description:</strong> Determines if the field&#39;s value is displayed in the document preview.</li>
<li><strong>Use:</strong> Highlight important fields in preview popups.</li>
</ul>
<hr>
<h3 id="-26-fetch_if_empty-"><strong>26. <code>fetch_if_empty</code></strong></h3>
<ul>
<li><strong>Description:</strong> Fetches the field value only if it is empty.</li>
<li><strong>Use:</strong> Avoid overwriting existing values while still providing default data when needed.</li>
</ul>
<hr>
<h3 id="-27-placeholder-"><strong>27. <code>placeholder</code></strong></h3>
<ul>
<li><strong>Description:</strong> Placeholder text displayed inside the field when it&#39;s empty.</li>
<li><strong>Use:</strong> Provide hints or examples for user input.</li>
</ul>
<hr>
<h3 id="-28-non_negative-"><strong>28. <code>non_negative</code></strong></h3>
<ul>
<li><strong>Description:</strong> Ensures the field value is non-negative.</li>
<li><strong>Use:</strong> For fields like quantity, price, or percentages, where negative values are invalid.</li>
</ul>
<hr>
<h3 id="-29-hide_border-"><strong>29. <code>hide_border</code></strong></h3>
<ul>
<li><strong>Description:</strong> Removes the border for fields, typically used for aesthetic purposes.</li>
<li><strong>Use:</strong> Create cleaner form designs by hiding borders for specific fields.</li>
</ul>
<hr>
<h3 id="-30-is_virtual-"><strong>30. <code>is_virtual</code></strong></h3>
<ul>
<li><strong>Description:</strong> Indicates that the field does not exist in the database and is calculated dynamically.</li>
<li><strong>Use:</strong> Use for fields that derive their values through formulas or scripts.</li>
</ul>
<hr>
<h3 id="-31-remember_last_selected_value-"><strong>31. <code>remember_last_selected_value</code></strong></h3>
<ul>
<li><strong>Description:</strong> Retains the last selected value for the field.</li>
<li><strong>Use:</strong> Speed up data entry by defaulting to the previously entered value.</li>
</ul>
<hr>
<h3 id="-32-link_filters-"><strong>32. <code>link_filters</code></strong></h3>
<ul>
<li><strong>Description:</strong> JSON object defining filters for linked fields.</li>
<li><strong>Use:</strong> Restrict the available options in <code>Link</code> fields based on specific criteria.</li>
</ul>
<hr>
<p>By using these fields effectively, users can tailor the behavior and appearance of individual fields within a Doctype to meet their specific business needs.</p>
